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abstract 


This  paper  describes  DBALERT,  which  performs  simple  alerting  for 
the  WAND  DBMS.  A demonstration  la  shown  using  DBALERT  to  per- 
form alerting  on  the  ONRODA  and  STSPIL  databases. 
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Tnis  paper  describes  DBALEflT,  which  performs  simple  alerting 
for  the  WAND  DBMS.  A demonstration  is  shown  using  DbALEKT 
to  perform  alerting  on  the  uwrtoi/A  and  SISfIL  databases. 


1.0  Introduction 
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DB ALERT  extends  DBLOOK  by  providing  interactive 
alerting  capabilities.  Alerting  is  the  ability  to  monitor 
databases  for  conditions  of  interest  to  the  user.  This  is 
accomplished  in  DB ALERT  by  allowing  the  user  to 
interactively  define  alerters,  which  will  monitor  the 
updates  to  the  database.  DBALERT  also  allows  the  user  to 
specify  information  which  will  be  reported  back  if  the 
condition  ever  becomes  true. 


1.1  Alerting  Capabilities 

DBALERT  allows  simple  alerters  to  be  defined  for 
additions,  deletions,  or  modifications  to  the  database. 
Simple  alerters  monitor  conditions  which  can  be  defined  in 
terms  of  a single  record  class.  An  example  of  a simple 
alerter  is  the  request 

"Report  any  savings  account  number  if  the  balance  of 
the  account  drops  below  $400.00.” 

where  savings  account  number  and  savings  balance  are  within 
the  same  record  type. 

Alerters  monitor  updates  to  the  database  rather  than 
its  present  state.  Conditions  are  never  evaluated  when  an 
alerter  is  just  defined  and  are  only  evaluated  as  true  when 
an  update  occurs  and  a condition  becomes  true  which  was  not 
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previously  true.  Therefore,  if  the  balance  dropped  from 
$450  to  $380  to  $360  then  only  the  drop  to  $380  would 
trigger  an  alerter. 

It  is  conceivable  that  the  user  may  want  to  be  alerted 
whenever  there  is  an  update  and  the  condition  is  true.  In 
this  case  field  names  within  the  condition  can  be  prefixed 
with  the  timed  variables  OLD:  or  NEW:.  Therefore,  in  the 
previous  example  if  the  balance  drops  from  $450  to  $380  to 
$360  then  both  drops  to  $380  and  $360  will  trigger  alerters. 


1.2  Using  DB ALERT 

In  order  to  use  DBALERT  the  user  must  have  specified 
the  ALERTED  DATABASE  clause  in  the  Schema  Entry.  If  this 
clause  was  not  specified  when  the  schema  was  created  then  a 
new  schema  and  sub-schema  must  be  created  with  this  clause 
included  in  the  Schema  Entry.  The  database  does  not  have  to 
be  reloaded.  Inclusion  of  this  clause  will  increase  the 
size  of  the  schema  and  the  running  times  of  programs. 
Therefore,  the  ALERTED  DATABASE  clause  should  only  be 
included  when  the  user  is  interested  in  monitoring  the 
database.  To  run  DBALERT  type  at  monitor  level 

X DBALERT 

At  this  point  any  of  the  HELP  commands  can  be  entered. 
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1 . 3  HELP  in  DBALERT 

HELP  in  DBALERT  extends  the  help  facility  of  DBLOOK  by 
providing  help  for  all  DBALERT  commands. 


1.4  DBALERT  Commands 

DBALERT  contains  the  following  types  of  commands: 

1.  The  ADDALERT  command  to  define  new  alerters. 

2.  Commands  to  manipulate  existing  alerters  and  obtain 
information  about  them. 


1.5  ADDALERT 

The  ADDALERT  command  is  of  the  form: 

ADDALERT  alerter-name  type  condition  report-list 

'Alerter-name'  ia  a user-defined  name  which  is  used  to 
identify  the  alerter.  'Alerter-name'  must  be  unique  and  is 
from  1 to  31  characters  in  length. 

'Type'  specifies  the  alerter  type  and  may  be  either 
XPADD,  IFDEL,  or  IPMOD.  IFADD  implies  that  this  alerter 
should  be  triggered  if  a record  is  added  to  the  database 
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which  satisfies  the  specified  condition.  IFDEL  will  trigger 
an  alerter  if  a record  with  the  condition  is  deleted  from 
the  database  and  IFMOD  triggers  the  alerter  if  any  data 
which  is  modified  meets  the  condition. 

'Condition'  specifies  the  condition  which  DBALERT  is  to 
monitor.  A condition  can  contain  literals,  field  names, 
arithmetic  operators,  relational  operators,  and  logical 
operators. 

Field  names  may  be  prefixed  with  optionally  specified 
time  qualification  (OLD:  or  NEW:),  where  OLD:  and  NEW: 

refer  to  the  pre  and  postupdate  values  of  an  item  in  a 
record  whose  update  triggers  an  alert. 

A literal  can  be  an  integer,  a real  number,  a double 
precision  number,  or  a character  string.  Character  strings 
must  be  enclosed  within  quotes  ('). 

The  following  arithmetic  operators  are  acceptable: 

**  exponentiation 
* multiplication 
/ division 
+ addition  (infix) 

or  designation  of  sign  (unary) 
subtraction  (infix) 
or  negation  (unary) 
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These  operators  are  used  to  combine  numeric  data-items  and 
numeric  literals  into  arithmetic  expressions. 
Exponentiation  has  the  highest  precedence,  followed  by 
multiplication  and  division  (which  have  equal  precedence) , 
then  unary  plus  and  negation  (which  have  equal  precedence) , 
and  finally  addition  and  subtraction  (which  also  have  equal 
precedence) . 

The  relational  operators  consist  of: 


EQ 

(-) 

equal  to 

NE 

not  equal  to 

GT 

(>) 

greater  than 

GE 

greater  than 

or  equal  to 

LT 

(<) 

less  than 

LE 

less  than  or 

equal  to 

Relational  operators  combine  data-items,  literals,  or 
arithmetic  expressions  into  relational  expressions. 
Relational  operators  are  of  equal  precedence  and  are  lower 
in  precedence  than  all  arithmetic  operators. 

DBALERT  accepts  the  logical  operators  AND,  OR,  and  NOT. 
Logical  operators  are  used  to  combine  relational  expressions 
and  logical  expressions  into  logical  expressions.  Logical 
operators  are  lower  in  precedence  than  both  arithmetic 
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A condition  is  evaluated  in  the  order  of  precedence  of 
the  operators.  If  there  is  more  than  one  operator  at  the 
same  precedence  level  then  they  are  evaluated  from  left  to 
right.  Parentheses  can  be  used  to  change  the  order  of 
evaluation. 

A condition  can  also  be  the  name  of  a record.  In  this 
case,  DB ALERT  will  monitor  the  database  for  additions, 
deletions,  or  modifications  to  the  specified  record. 

'Report-list'  contains  a list  of  field  names  or 
character  strings  which  are  reported  back  if  the  alerter  is 
triggered.  The  report-list  can  contain  the  keywords  DATE 
and  TIME  which  report  the  date  and  time  the  alerter  was 
triggered. 


1.6  LIST 

The  command  LIST  will  list  the  names  of  all  the 
alerters. 


1.7  ERASE 

Alerters  can  be  deleted  by  using  the  ERASE  command. 
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ERASE  alerter-name 

A similar  command  is  ERASE  ALL  which  deletes  all  the 
defined  alerters. 


1.8  DEACTIVATE 

An  alerter  is  made  inactive  by  the  DEACTIVATE  command. 
An  inactive  alerter  can  never  be  triggered. 

DEACTIVATE  alerter-name 

DEACTIVATE  ALL  deactivates  all  defined  alerters. 

1.9  ACTIVATE 

The  ACTIVATE  command  is  used  to  activate  an  inactive 
alerter. 

ACTIVATE  alerter-name 

All  alerters  can  be  activated  by  the  command  ACTIVATE 
ALL.  An  alerter  is  active  on  being  created. 

1.10  STATE 
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The  STATE  command  will  list  the  current  state  of  an 
alerter. 

STATE  alerter-name 

The  following  information  is  provided  by  the  STATE 
command : 

1.  The  number  of  times  this  alerter  has  been 
triggered. 

2.  The  date  this  alerter  was  last  triggered. 

3.  The  time  this  alerter  was  last  triggered. 

4.  Whether  this  alerter  is  inactive  or  active. 

STATE  ALL  will  display  this  information  for  all  defined 
alerters . 


1.11  Demonstration 

This  section  contains  an  actual  terminal  session  with 
DBALERT.  In  this  demonstration,  both  the  SYSFIL  and  ONRODA 
databases  are  monitored. 

.X  DBALERT 

Welcome  to  B.07  DBLOOK  and  SEED.  Type  HELP  or  ? for  info. 

* WATCH 


Which  database  would  you  like  to  watch?  SYSFIL 


* *LOOK  AT  SYSREC  RECORD  IN  SYSFIL  DATABASE 

* SYSREC 

RECORD  NAME  IS  SYSREC 
WITHIN  AREAl 

LOCATION  MODE  IS  CALC  USING  JOBNUMBER 
DUPLICATES  ARE  NOT  ALLOWED. 

CONTAINS  THE  FOLLOWING  ITEMS: 

JOBNUMBER 

USERNAME 

TTY 

PROGNAME 

PROJECTNUMBER 

PROGRAMMERNUMBER 

* *NOW  DEFINE  SOME  ALERTERS 

* ADDALERT 
Alerter  name 

* MON I TOR_DB AL  E RT_U  S E RS 
Alerter  type 

* IFADD 
Condition 

* PROGNAME  EQ  ' DBALER 1 
Report  list 

* USERNAME  ' IS  USING  DBALERT ' 

* ADDALERT  MONITOR_BUNEMAN  IFMOD 
Condition 

* USERNAME  = 'BUNEMA'  AND  PROGNAME  EQ  ’PASCAL' 
Report  list 

* 'PETER  BUNEMAN  IS  USING  PASCAL' 

* LIST 

MON I TOR_DB  AL fi  RT_USE RS 
MON ITOR_B  UN  EM AN 

* *NOW  LETS  UPDATE  THE  SYSFIL  DATABASE 


* 


UPDATE 
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Enter  frequency  of  checking  (integer  seconds)  : 30 

Total  monitoring  time  ? (integer  minutes):  1 

ALERT  MONITOR_DBALERT_USERS 
RIBEIJ  IS  USING  DBALERT 
* WATCH 


Which  database  would  you  like  to  watch?  ONRODA 
* ^DELETE  ALL  DEFINED  ALERTERS 


ERASE  ALL 


Confirm (Y  OR  N) :Y 


All  alerters  deleted 

* *LETS  DEFINE  SOME  ALERTERS  FOR  THE  ONRODA  DATABASE 


ADDALERT  BESSMENY  SIGHTED  IFADD 


Condition 


TRACK-NAME  EG  'BESSMENY' 


Report  list 


'THE  BESSMENY  WAS  SIGHTED' 


ADDALERT  RED-CONTACT-FLAG  IFADD 


Condition 


CONTACT-FLAG  = 'RD1 


Report  list 


CONTACT-NAME  'WAS  SIGHTED  WITH  RED  FLAG' 


ADDALERT 


Alerter  name 


LOW  FUEL  RESERVE 


Alerter  type 


IFADD 


Condition 


SHIP-PERCENT-FUELED  <65 


Report  list 


< 
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'FUEL  RESERVES  HAVE  DROPPED  BELOW  65%  FOR'  STATUS-SHIP-NAME 


Enter  name  of  file  containing  database  updates:  UPDl.DAT 

Enter  time  compression  factor:  8000 

Track-record  being  stored  § 7702111830 
Track-number  = 4 

Track-name  * BESSMENY 
Track-force  * 7 

ALERT  BESSMENY_SIGHTED 
THE  BESSMENY  WAS  SIGHTED 

Contact-report  record  now  being  stored  @ 7702111830 
Contact-name  * BESSMENY 
Contact-flag  * RD 
Contact-course  * ***** 

Contact-speed  3 ***** 

Contact-altitude  * 

Contact-latitude  3 31-00N 
Contact-longitude  * 26-00E 
Contact-dtg  3 7702111830 
Contact-semi-major-axis  3 10 

Contact-semi-minor-axis  3 10 

Contact-angle  3 ***** 

Contact-emitter  3 
ALERT  RED-CONTACT-FLAG 
BESSMENY  WAS  SIGHTED  WITH  RED  FLAG 

Track-record  being  stored  @ 7702111830 
Track-number  3 10 

Track-name  3 DODRY 
Track-force  3 7 

Contact-report  record  now  being  stored  @ 7702111830 
Contact-name  3 DODRY 
Contact-flag  3 RD 
Contact-course  3 ***** 

Contact-speed  ■ ***** 

Contact-altitude  3 
Contact-latitude  3 30-40N 
Contact-longitude  3 26-40E 
Contact-dtg  3 7702111830 
Contact-semi-major-axis  3 10 

Contact-semi-minor-axis  3 10 

Contact-angle  3 ***** 

Contact-emitter  3 
ALERT  RED-CONTACT-FLAG 
DODRY  WAS  SIGHTED  WITH  RED  FLAG 

Defence-condition-record  now  being  modified  @ 7702151645 
Defence-condition-id  3 1 

Defence-condition  3 


3 
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Weather  record  now  being  stored  @ 7702151730 
Weather-dtg  - 7702151730 
Weather-precip-type  * RN 
Weather-precip-rate  * 1.100 

Equipment-casualty-report  now  being  stored  @ 7702151745 
Equipment-id  * CG-11 

Equipment-casualty-report-dtg  * 7702151745 
Equipment-name  * RIM-24 
Equipment-readiness  ■ 1 

Ship-status-report  record  now  being  stored  @ 7702151930 
Ship-status-report-dtg  * 7702151930 
Ship-percent-fueled  * 60 

Status-ship-name  * COCHRANE 
ALERT  LOW_FUEL_RESERVE 

FUEL  RESERVES  HAVE  DROPPED  BELOW  65%  FOR  COCHRANE 

Track-record  being  stored  @ 7702152020 
Track-number  * 2 

Track-name  * UNK 
Track-force  = 5 

Equipment-casualty-report  now  being  stored  @ 7702152030 
Equipment-id  * DD-964 

Equipment-casualty-report-dtg  * 7702152030 
Equipment-name  * SONAR 
Equipment-readiness  * 3 
* EXIT 

STOP 

END  OF  EXECUTION 

CPU  TIME:  22.57  ELAPSED  TIME:  3:19.08 
EXIT 
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